home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
pc_board
/
pcbll097.zip
/
PCBCALL.DOC
< prev
next >
Wrap
Text File
|
1992-08-01
|
6KB
|
141 lines
PCBCALL - version 1
=====================
By: Larry Schwenk
If your like me, you hate reading documentation files as much as I
hate writing them. So I'm going to get right to the point...
What is PCBCALL
==============================
This program is designed to work with the PCBoard BBS system. It
will help sysops regain control of their CALLER log file. This
version of PCBCALL can accomplish this by three methods:
1 - keep only a specified number of lines
2 - keep only a specified number of days
3 - remove any users from the file, ie. since sysops normally enter
the system multiple times a day, an analysis of the log file
would be corrupted if the sysop's logs were not removed.
a) - you can also do a conditional deletion. Just use the
@ symbol in front of the name to be deleted. The system
will then prompt you every time to see if it IS what you
want deleted. The entire line from the log file is displayed
for your reference. There is a built in 15 second delay
so if you don't hit a key within that time, the program will
assume that your response is NO and the record will not be
deleted.
How PCBCALL works
==============================
The program must be passed a file name as a command line parameter.
PCBCALL.EXE <file.cfg>
where <file.cfg> is an ASCII file that contains the following:
line 1: full path and file name to caller log file
line 2: full path and file name for the new caller log file
line 3: total number of lines to keep
line 4: total number of days to keep
line 5: the first user name to be removed
line 6: the second user name to be removed
line 7: ...
The smallest <file.cfg> must contain at least the first three
lines.
PCBCALL.DOC Page 2
==================================================================
EXAMPLES:
file1.cfg file2.cfg file3.cfg
------------------ ------------------ ------------------
c:\pcb\main\caller c:\pcb\main\caller c:\pcb\main\caller
c:\pcb\main\newfile c:\pcb\main\newfile c:\pcb\main\newfile
4000 0 0
14 21
larry schwenk
@john doe
file1.cfg - would remove all but the last 4000 lines of the log
file. It will not however split a user's entry, but
will rather start the updated log at the point at which
they logged off.
file2.cfg - would remove all but the last 14 days of caller activity.
After all the 'old' entries are removed the program will
then remove any log entry made by these two individuals.
They must be spelled EXACTLY, case is not your concern.
There can be up to 30 names listed, but they must start
on line 5 of the config file. Since the @ symbol is used
in front of the second name the program will prompt you
for every entry found by "john doe".
file3.cfg - would remove all but the last 21 days of activity.
If both a total number of lines to keep and a keep total number of
days is specified in the config file, ONLY the lines option will be
executed, the days will be ignored, however any names that follow
will still be removed if present.
If names are to be removed it will be the final process to be
performed.
If you want to keep just a total number of lines, but still remove
a couple of users AND want the users removed FIRST before the file
is cut 'down to size' then you can simply run the program twice
with two different config files. The first with lines and days set
to 0 and the names listed, and the second file with just the lines
option.
You may have line 2 exactly the same as line 1, which will simply
replace the old caller file. However, this may cause some problems
with people using SHARE.EXE and having more than one node.
PCBCALL.DOC Page 3
==================================================================
Author Support
==============================
You may have already noticed that there are no SHAREWARE notices
all over the place. That is because I'm releasing this version of
the program as FREEWARE. All I ask is that you let me know what
you think of it and offer your suggestions for future improvements.
All updates to PCBCALL will be available on Salt Air BBS.
If you have a problem there are several ways to contact me:
Desert Highlands BBS (816) 429-6245 HST/DS 16.8
Salt Air BBS
INTELEC Network (PCBoard conference)
CompuServe 71270,2053
All written correspondence should be mailed to:
Larry Schwenk
182 SE 411
Warrensburg, MO 64093
Legal Stuff
==============================
I've tested this program over and over again. I have not found any
problems with it, but that does not mean that it is error free. So
you are to use this program at your own risk. As I can not be held
responsible for anything that might go wrong.